home *** CD-ROM | disk | FTP | other *** search
/ MPEG Toolkit / MPEG Toolkit.iso / os2 / mpegenc / src / install < prev    next >
Text File  |  1997-01-01  |  3KB  |  59 lines
  1. This file describes how to install the Berkeley MPEG encoder.  Installation
  2. should be a quick and painless task.  Just do the following in order:
  3.  
  4.     1)  The encoder uses the pbmplus library.  If your system already has
  5.     the files libpnm.a, libppm.a, libpgm.a, and libpbm.a, and the files
  6.     pbm.h, pgm.h, ppm.h, and pnm.h, then change the Makefile:  redefine
  7.     the variables PBMLIBDIR and PBMHDRDIR to point to the directories 
  8.     where those files reside.  If your system already has the files, 
  9.     then skip step 2, otherwise go to step 2.
  10.  
  11.     2)  You may need to edit pbmplus/Makefile and pbmplus/pbmplus.h
  12.     to configure everything properly for your system.  As we ship things,
  13.     you shouldn't have to change anything for pbmplus to work properly
  14.     on a Sparc, HP, or DEC.  Type 'make' in the pbmplus directory to
  15.     create the appropriate libraries.
  16.  
  17.     3)  If your machine does not have UNIX sockets, then you cannot use
  18.     the parallel version of the encoder.  Thus, you must edit the
  19.     Makefile, changing MP_PARALLEL_OBJS and MP_PARALLEL_SRCS.
  20.     Instead of parallel.c and parallel.o, they should be noparallel.c
  21.     and noparallel.o.
  22.     
  23.     4)  We assume that right shift corresponds to signed division by 2 with
  24.     rounding towards minus infinity.  This is correct for typical "arithmetic
  25.     shift" instructions that shift in copies of the sign bit.  But some
  26.     C compilers implement >> with an unsigned shift.  For these machines you
  27.     must define RIGHT_SHIFT_IS_UNSIGNED.  To do so, add
  28.     -DRIGHT_SHIFT_IS_UNSIGNED to your CFLAGS line.
  29.  
  30.     5)  Edit the Makefile.  Set CC accordingly.  Set CFLAGS
  31.     accordingly.  Some sample CFLAGS lines for several different
  32.     compilers/machines are given in the Makefile.  If long's on your
  33.     machine are 32 bits but int's are NOT 32 bits, then you must include
  34.     the -DLONG_32 option in your CFLAGS line.  If your system does not
  35.     have the netinet/in.h header, then you must add either -DFORCE_BIG_ENDIAN
  36.     or -DFORCE_LITTLE_ENDIAN to the CFLAGS line (which you use depends on
  37.     your machine).
  38.  
  39.     6)  Set the LIBS lines appropriately.  For most machines you don't need
  40.     to change this.  However, for some machines you'll need to include
  41.     additional libraries to use sockets.
  42.  
  43.     7)  If you are using a NON-ANSI compiler, then your CFLAGS should
  44.     include -DNON_ANSI_COMPILER
  45.  
  46.     8)  Type 'make clean'
  47.  
  48. If all is well, you should get the executable file 'mpeg_encode.'  To
  49. test it, try 'make test.'  At the end of the test, it should say SUCCESS
  50. or FAILURE.  If it says FAILURE, please let us know!
  51.  
  52. Note: if you get warnings about certain C library procedures not being
  53. defined before being called, that's not our fault.  Prototypes
  54. *should* exist in the appropriate system header files in /usr/include,
  55. but on some systems they don't.  None of this should affect the
  56. correctness of the program, but if you get tired of the warnings, you
  57. can probably stop them by setting PROTOFLAG = -DMISSING_PROTOTYPES in
  58. the Makefile.
  59.